Example Applications¶

Running the Application¶

Perform the following steps to run the OOB collector example application.

1. Import the collector_cc13x0lp project as described in Importing SDK Projects.

2. After importing, configure the following settings in the config.h file. To configure the settings on the collector application project: Select the collector_cc13x0lp project in the CCS Project Explorer window. Find the config.h file, as shown in Figure 50..

   

   Figure 50. Collector Example Application Folder Project Explorer View

   1. Set CONFIG_PAN_ID to the desired PAN ID.

   2. Set CONFIG_PHY_ID according to region of interest:

      1. For a US or 915-MHz band of operation, use the OOB CONFIG_PHY_ID settings as:

         /*! Setting for Phy ID */
         #define CONFIG_PHY_ID (APIMAC_STD_US_915_PHY_1)
         

      2. For ETSI PHY for Europe (or 868-MHz band operation), configure the CONFIG_PHY_ID parameter:

         /*! Setting for Phy ID */
         #define CONFIG_PHY_ID (APIMAC_STD_US_915_PHY_3)
         

      3. For China or 433-MHz band of operation, configure CONFIG_PHY_ID as:

         /*! Setting for Phy ID */
         #define CONFIG_PHY_ID (APIMAC_GENERIC_CHINA_433_PHY_128)
         

      Note

      Each PHY also has a SimpleLink Long Range, (SLM), mode of operation. This mode gives extended range, and has a data rate of 5kbps. The SLM PHY ID’s are:

      • APIMAC_GENERIC_US_LRM_915_PHY_129
      • APIMAC_GENERIC_CHINA_LRM_433_PHY_130
      • APIMAC_GENERIC_ETSI_LRM_863_PHY_131

   3. Set the preferred channel of operation in the CONFIG_CHANNEL_MASK parameter:

      /*!
      Channel mask used when CONFIG_FH_ENABLE is false
      Each bit indicates if the corresponding channel is to be
      scanned First byte represents channel 0 to 7 and the last byte represents channel 128 to 135
      */
      
      #define CONFIG_CHANNEL_MASK { 0x0F, 0x00, 0x00, 0x00, 0x00, 0x00, \
      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
      0x00, 0x00, 0x00, 0x00, 0x00 }
      

      The channel numbers available in each band follow:

      1. 902 to 928 MHz (50 kbps): 0 to 128, such as when CONFIG_PHY_ID = APIMAC_STD_US_915_PHY_1
      2. 863 to 870 MHz (50 kbps): 0 to 33, such as when CONFIG_PHY_ID = APIMAC_STD_ETSI_863_PHY_3
      3. 433 to 434 MHz (50 kbps): 0 to 6, such as when CONFIG_PHY_ID = APIMAC_GENERIC_CHINA_433_PHY_128

   In addition to the preceding configuration settings, note that when the devices join the network, the collector application configures the joining devices on how often to report the sensor data. To change or configure the interval at which the joining sensor devices report the sensor data, set the parameter CONFIG_REPORTING_INTERVAL to the desired value in milliseconds in the collector.c file. By default, the sensor reporting interval is set to 90 seconds, as shown by the following code snippet from the collector.c file:

   /* Default configuration reporting interval, in milliseconds */
   #define CONFIG_REPORTING_INTERVAL 90000
   

3. In the CCS Project Explorer, select the collector_cc13x0lp project.

4. Right-click on the collector_cc13x0lp project, and select the Build option. This builds the collector application project.

5. Download the project onto the CC13x0 LaunchPad by selecting Debug from the Run tab (see Figure 51.).

   

   Figure 51. Debug Option

6. Terminate the debug session when the download is complete.

   

   Select Terminate Option

7. If the AUTO_START compile flag is enabled, press BTN-1 to start the collector. The red LED on the LaunchPad turns on, and the display on the LCD should appear as in Figure 53..

   

   Figure 53. LCD Display (1 of 2)

   

   Figure 54. Hyperterminal When Collector is Started

   Note

   If you want to use LCD BoosterPack, remove USE_UART_PRINTF in the predefined symbols.

8. Press the BTN-2 button on the collector LaunchPad to allow new devices to join the network. Pressing the BTN-2 a second time closes the network, and new devices are not be able to join the network. Press button 2 a third time to allow new devices to join the network. When the network is open to new devices, the red LED blinks; when it does not blink, the network is closed to new devices. After the sensor successfully joins the network, the LCD on the collector LaunchPad is as shown in Figure 55..

   

   Figure 55. LCD Display (2 of 2)

   

   Figure 56. Hyperterminal When Sensor Joins Collector

   Note

   For instructions on programming and running the sensor application, see Sensor.

Running the Application¶

Perform these steps to run the out-of-box Sensor Example Application.

1. Import the sensor_cc13x0lp project, as described in Importing SDK Projects.

2. After importing, configure the following settings in the config.h file. To configure the settings on the sensor application project:

   1. Select the sensor_cc13x0lp project in the CCS Project Explorer window.

   2. Find the config.h file, as shown in Figure 57..

      

      Figure 57. Config.h File

   3. Set #define CONFIG_PAN_ID to the desired value to match the collector.

   4. Set the Phy ID according to region of interest:

      1. For a US or 915-MHz band of operation, use the OOB CONFIG_PHY_ID settings:

         /*! Setting for Phy ID */
         #define CONFIG_PHY_ID (APIMAC_STD_US_915_PHY_1)
         

      2. For ETSI PHY for Europe (or 868-MHz band operation), configure the CONFIG_PHY_ID parameter:

         /*! Setting for Phy ID */
         #define CONFIG_PHY_ID (APIMAC_STD_US_915_PHY_3)
         

      3. For China or 433-MHz band of operation, configure CONFIG_PHY_ID as::

         /*! Setting for Phy ID */
         #define CONFIG_PHY_ID (APIMAC_GENERIC_CHINA_433_PHY_128)
         

   5. Set the preferred channel of operation (matching the collector) in CONFIG_CHANNEL_MASK:

      /*!
      Channel mask used when CONFIG_FH_ENABLE is false
      Each bit indicates if the corresponding channel is to be
      scanned First byte represents channel 0 to 7 and the last byte represents channel 128 to 135
      */
      
      #define CONFIG_CHANNEL_MASK { 0x0F, 0x00, 0x00, 0x00, 0x00, 0x00, \
      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
      0x00, 0x00, 0x00, 0x00, 0x00 }
      

      The channel numbers available in each band follow:

      1. 902 to 928 MHz (50 kbps): 0 to 128, such as when CONFIG_PHY_ID = APIMAC_STD_US_915_PHY_1
      2. 863 to 870 MHz (50 kbps): 0 to 33, such as when CONFIG_PHY_ID = APIMAC_STD_ETSI_863_PHY_3
      3. 433 to 434 MHz (50 kbps): 0 to 6, such as when CONFIG_PHY_ID = APIMAC_GENERIC_CHINA_433_PHY_128

      Note

      Each PHY also has a SimpleLink Long Range, (SLM), mode of operation. This mode gives extended range, and has a data rate of 5kbps. The SLM PHY ID’s are:

      • APIMAC_GENERIC_US_LRM_915_PHY_129
      • APIMAC_GENERIC_CHINA_LRM_433_PHY_130
      • APIMAC_GENERIC_ETSI_LRM_863_PHY_131

3. Build the stack project, then connect a LaunchPad to the PC, and call it sensor-launchpad.

4. Download the stack project onto the sensor-launchpad, and terminate the debug session when the download is finished.

5. Build the sensor application project and download it onto the CC13x0 LaunchPad using the method previously used to download the stack and terminate the debug session once the download is complete.

6. Terminate the debug session when the download is complete. The initial state of the LCD before the sensor joins a network is as shown in Figure 58..

   

   Figure 58. LCD Sensor Display (1 of 2)

   

   Figure 59. Hyperterminal When Sensor is Powered Up

   After the sensor successfully joins the network, the LCD on sensor LaunchPad is as shown in Figure 60..

   

   Figure 60. LCD Sensor Display (2 of 2)

   

   Figure 61. Hyperterminal When Sensor Joins The Network

   Note

   After the sensor node has successfully joined the network, it receives a configuration request message from the collector application. The node then configures the time interval on how often to report the sensor data to the collector application, and how often to poll for buffered messages in case of sleepy devices. After receiving the configuration request message, the green LED toggles whenever the device sends the message.

Linux Collector and Gateway Application¶

These two example applications are provided inside the TI 15.4-Stack Linux SDK installer, a component of the TI 15.4-Stack. The Linux collector example application interfaces with the CC13x0 running the coprocessor and stack image through a UART. The Linux collector example application provides the same functionality as the embedded collector application, while also providing a socket server interface to the Linux gateway application. The Linux gateway application implemented within the Node.js framework connects as a client to the socket server created by the Linux collector example application, and establishes a local web server to which the user can connect through a web browser (in the local network), and monitor and control the network devices. The collector and gateway applications can be great starting points for creating IOT applications. For more details, refer to the TI 15.4-Stack Linux Developer’s Guide included with the TI 15.4-Stack Linux SDK installer.

Linux Serial Bootloader Application¶

This example application is included inside the TI 15.4-Stack Linux SDK installer. This application provides the capability to upgrade the firmware of the CC13x0 MCU through the CC13x0 ROM bootloader. For more details, refer to the TI 15.4-Stack Linux Developer’s Guide included with the TI 15.4-Stack Linux SDK installer.